home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il_c / ilMergeImg.z / ilMergeImg
Encoding:
Text File  |  2002-10-03  |  11.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg - merge several images into one
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      ilLink : ilImage : ilCacheImg : ilMemCacheImg : ilOpImg
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <il/ilCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      This class is publicly derived from ilOpImg. This class makes it possible
  19.      to merge a number of images, all of the same size, into one. This merged
  20.      image can now be treated as an independent ilImage. One can also assign a
  21.      data type and order to this merged image that may be different from the
  22.      parent images. The number of channels in the merged image is equal to the
  23.      sum of the number of channels of the parent images. One can imagine the
  24.      images to be stacked up one behind the other in the order in which they
  25.      are specified.
  26.  
  27.      Among the important public member functions are three different
  28.      constructors.  They differ in the way the order and type of the merged
  29.      image is specified.
  30.  
  31.      The reset function inherited from ilLink is redefined so that ilMergeImg
  32.      attributes that have not been explicitly set, are set to those of the
  33.      first parent image during the reset operation.
  34.  
  35. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  36.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
  37.  
  38.           ilMergeImg *ilMergeImgCreate(ilImage** imgPtr, int nimg, iflOrder order,
  39.                                        iflDataType dtype)
  40.           ilMergeImg *ilMergeImgFirst(int nimg, ilImage** imgPtr)
  41.           ilMergeImg *ilMergeImg3(ilImage* img0, ilImage* img1, ilImage* img2,
  42.                                   iflOrder order, iflDataType dtype);
  43.  
  44.  
  45. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  46.      iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg(((())))
  47.  
  48.           ilMergeImg *ilMergeImgCreate(ilImage** imgPtr, int nimg, iflOrder order,
  49.                                        iflDataType dtype)
  50.           ilMergeImg *ilMergeImgFirst(int nimg, ilImage** imgPtr)
  51.           ilMergeImg *ilMergeImg3(ilImage* img0, ilImage* img1, ilImage* img2,
  52.                                   iflOrder order, iflDataType dtype);
  53.  
  54.  
  55.           In the first two constructors listed above, _i_m_g_P_t_r is an array of
  56.           pointers to the input ilImages.  The number of images to be merged
  57.           is specified by _n_i_m_g. The first _n_i_m_g ilImages in the list are
  58.           merged, any others are ignored.  Therefore, _i_m_g_P_t_r should have at
  59.           least _n_i_m_g pointers.  The final constructor allows up to three
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))
  71.  
  72.  
  73.  
  74.           images, _i_m_g_0, _i_m_g_1 and _i_m_g_2, to be specified without requiring an
  75.           array of images to be constructed. Any or all of these images
  76.           pointers may be NULL.
  77.  
  78.           The first and last constructors allow you to specify an order and
  79.           type for the merged image.  If the default data type, 0, is used,
  80.           the data type of the merged image is taken to be the data type with
  81.           the most precision of the input images.  In the second constructor,
  82.           the order and data type of the merged image is taken to be the first
  83.           ilImage pointed to by _i_m_g_P_t_r.
  84.  
  85. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  86.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllOOOOppppIIIImmmmgggg
  87.      ilOpImgClearClamp(), ilOpImgGetBias(), ilOpImgGetClamp(),
  88.      ilOpImgGetValidOrders(), ilOpImgGetValidTypes(), ilOpImgIsClamped(),
  89.      ilOpImgIsPrecisionKept(), ilOpImgKeepPrecision(), ilOpImgSetBias(),
  90.      ilOpImgSetClampMinMax(), ilOpImgSetClamp()
  91.  
  92.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllMMMMeeeemmmmCCCCaaaacccchhhheeeeIIIImmmmgggg
  93.      ilMemCacheImgEnableMP(), ilMemCacheImgGetPageTime(),
  94.      ilMemCacheImgGetRetainMode(), ilMemCacheImgGetThrashMode(),
  95.      ilMemCacheImgGetThrashTime(), ilMemCacheImgGetTotalPageTime(),
  96.      ilMemCacheImgIsMPenabled(), ilMemCacheImgSetRetainMode(),
  97.      ilMemCacheImgSetThrashMode()
  98.  
  99.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllCCCCaaaacccchhhheeeeIIIImmmmgggg
  100.      ilCacheImgFlush(), ilCacheImgGetCacheSize()
  101.  
  102.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllIIIImmmmaaaaggggeeee
  103.      ilAddInput(), ilAllocFillData(), ilClipTile(), ilClipTileAsTile(),
  104.      ilClipTileFloat(), ilClipTileFloatAsTile(),
  105.      ilConfigureRetainedCacheImage(), ilCopy(), ilCopyTile(), ilCopyTile3D(),
  106.      ilCopyTileCfg(), ilFillTile(), ilFillTile3D(), ilFillTileRGB(),
  107.      ilFreeFillData(), ilGetColorImg(), ilGetColorModel(), ilGetColormap(),
  108.      ilGetColormapPtr(), ilGetCompression(), ilGetConfig(), ilGetCsize(),
  109.      ilGetDataType(), ilGetDimensions(), ilGetDirectInput(),
  110.      ilGetDisplayCacheEnable(), ilGetFill(), ilGetFillData(),
  111.      ilGetFillValue(), ilGetHeight(), ilGetHwEnable(), ilGetHwHint(),
  112.      ilGetHwHintName(), ilGetHwIntHint(), ilGetHwIntHintName(), ilGetInput(),
  113.      ilGetInputTileRequirement(), ilGetLockTileSet(), ilGetMappedPageSize(),
  114.      ilGetMappedSize(), ilGetMaxColormapLevels(), ilGetMaxValue(),
  115.      ilGetMinValue(), ilGetNumChans(), ilGetNumInputs(), ilGetOrder(),
  116.      ilGetOrientation(), ilGetPageBorder(), ilGetPageBorderPtr(),
  117.      ilGetPageBorderX(), ilGetPageBorderY(), ilGetPageBorderZ(),
  118.      ilGetPageCounts(), ilGetPageDelta(), ilGetPageDeltaStruct(),
  119.      ilGetPageDimensions(), ilGetPageIndices(), ilGetPageOrigin(),
  120.      ilGetPageOriginC(), ilGetPageOriginStruct(), ilGetPageOriginX(),
  121.      ilGetPageOriginY(), ilGetPageOriginZ(), ilGetPageSize(),
  122.      ilGetPageSizeBytes(), ilGetPageSizeC(), ilGetPageSizePix(),
  123.      ilGetPageSizeStruct(), ilGetPageSizeVal(), ilGetPageSizeX(),
  124.      ilGetPageSizeXY(), ilGetPageSizeY(), ilGetPageSizeZ(), ilGetPixel(),
  125.      ilGetPixel3D(), ilGetPriority(), ilGetScaleMax(), ilGetScaleMin(),
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllMMMMeeeerrrrggggeeeeIIIImmmmgggg((((3333))))
  137.  
  138.  
  139.  
  140.      ilGetSize(), ilGetSizePtr(), ilGetStrides(), ilGetSubTile(),
  141.      ilGetSubTile3D(), ilGetTile(), ilGetTile3D(), ilGetWidth(), ilGetXsize(),
  142.      ilGetYsize(), ilGetZsize(), ilHasPageBorder(), ilHasPages(),
  143.      ilInitScaleMinMax(), ilIsColorImg(), ilIsIntegral(),
  144.      ilIsMirrorOrientation(), ilIsSigned(), ilIsWritable(), ilLockPage(),
  145.      ilLockPageSet(), ilLockTile(), ilLockTile3D(), ilMapFlipTrans(),
  146.      ilMapFromInput(), ilMapFromInput2D(), ilMapFromInput3D(),
  147.      ilMapFromSource(), ilMapFromSource2D(), ilMapFromSource3D(),
  148.      ilMapOrientation(), ilMapSize(), ilMapTile(), ilMapTileFlipTrans(),
  149.      ilMapTileFloat(), ilMapToInput(), ilMapToInput2D(), ilMapToInput3D(),
  150.      ilMapToSource(), ilMapToSource2D(), ilMapToSource3D(), ilMapXY(),
  151.      ilMapXYFloat(), ilMapXYSign(), ilQCopyTileCfg(), ilQFillTile3D(),
  152.      ilQFillTileRGB(), ilQGetSubTile3D(), ilQGetTile3D(), ilQLockPageSet(),
  153.      ilQSetSubTile3D(), ilQSetTile3D(), ilRemoveHwHint(),
  154.      ilRemoveHwHintName(), ilRemoveInput(), ilSetColorModel(),
  155.      ilSetColormap(), ilSetCompression(), ilSetCsize(), ilSetDataType(),
  156.      ilSetDisplayCacheEnable(), ilSetFill(), ilSetFillValue(),
  157.      ilSetHwEnable(), ilSetHwHint(), ilSetHwIntHint(), ilSetHwIntHintName(),
  158.      ilSetInput(), ilSetMaxColormapLevels(), ilSetMaxValue(), ilSetMinValue(),
  159.      ilSetNumChans(), ilSetOrder(), ilSetOrientation(), ilSetPageBorder(),
  160.      ilSetPageBorderStruct(), ilSetPageSize(), ilSetPageSizeC(),
  161.      ilSetPageSizeStruct(), ilSetPageSizeXY(), ilSetPageSizeZ(), ilSetPixel(),
  162.      ilSetPixel3D(), ilSetPriority(), ilSetScaleMinMax(), ilSetScaleType(),
  163.      ilSetSize(), ilSetSubTile(), ilSetSubTile3D(), ilSetTile(),
  164.      ilSetTile3D(), ilSetXYsize(), ilSetXsize(), ilSetYsize(), ilSetZsize(),
  165.      ilUnlockPage(), ilUnlockPageSet()
  166.  
  167.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllLLLLiiiinnnnkkkk
  168.      ilLinkClearSet(), ilLinkClearStatus(), ilLinkGetDescription(),
  169.      ilLinkGetDirectParent(), ilLinkGetDisabledIndex(), ilLinkGetFloatProp(),
  170.      ilLinkGetGenerationID(), ilLinkGetIntProp(), ilLinkGetNumChildren(),
  171.      ilLinkGetNumParents(), ilLinkGetParent(), ilLinkGetPtrProp(),
  172.      ilLinkGetRelatedChild(), ilLinkGetRelatedDelete(),
  173.      ilLinkGetRelatedType(), ilLinkGetStatus(), ilLinkIsAllowed(),
  174.      ilLinkIsAltered(), ilLinkIsEnabled(), ilLinkIsRelated(), ilLinkIsSet(),
  175.      ilLinkRemoveParent(), ilLinkRemoveProp(), ilLinkSetDescription(),
  176.      ilLinkSetDisabledIndex(), ilLinkSetEnabled(), ilLinkSetParent(),
  177.      ilLinkSetProp(), ilLinkSetRelatedDelete(), ilLinkSetRelatedType()
  178.  
  179. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  180.      ilLink(3), ilImage(3), ilCacheImg(3), ilMemCacheImg(3), ilOpImg(3)
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.